home *** CD-ROM | disk | FTP | other *** search
/ Cinema Studio: Frank Herrmann / Cinema Studio - Frank Herrmann.iso / tools / pbm / manuals / sldtoppm.man < prev    next >
Text File  |  1994-03-01  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.      sldtoppm(1)          AMIGA (10 October 1991)          sldtoppm(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           sldtoppm - convert an AutoCAD slide file into a portable
  10.           pixmap
  11.  
  12.      SYNOPSIS
  13.           sldtoppm [-adjust] [-dir] [-height|-ysize s] [-info] [-
  14.                    lib|-Lib name] [-scale s] [-verbose] [-width|-xsize
  15.                    s] [slidefile]
  16.  
  17.      DESCRIPTION
  18.           Reads an AutoCAD(Reg.) slide file  and  outputs  a  portable
  19.           pixmap.   If  no  slidefile is specified, input is read from
  20.           standard input.  The ppmdraw library is used to convert  the
  21.           vector  and  polygon  information  in  the  slide  file to a
  22.           pixmap; see the file ppmdraw.h for details on this package.
  23.  
  24.      OPTIONS
  25.           -adjust
  26.                If the display on which the slide file was created  had
  27.                non-square  pixels,  when  the  slide is processed with
  28.                sldtoppm and the -adjust option  is  not  present,  the
  29.                following warning will appear:
  30.                  Warning - pixels on source screen were non-square.
  31.                  Specifying  -adjust  will  correct  image  width   to
  32.                  compensate.
  33.                Specifying the -adjust option causes sldtoppm to  scale
  34.                the  width of the image so that pixels in the resulting
  35.                portable pixmap are square (and hence circles appear as
  36.                true  circles, not ellipses).  The scaling is performed
  37.                in  the  vector  domain,  before  scan  converting  the
  38.                objects.   The  results  are,  therefore,  superior  in
  39.                appearance to what you'd obtain were you to perform the
  40.                equivalent  scaling  with pnmscale after the bitmap had
  41.                been created.
  42.  
  43.           -dir The input is assumed to be  an  AutoCAD  slide  library
  44.                file.  A directory listing each slide in the library is
  45.                printed on standard error.
  46.  
  47.           -height size
  48.                Scales the image in the vector domain  so  it  is  size
  49.                pixels  in  height.   If  no -width or -xsize option is
  50.                specified, the width will be adjusted to  preserve  the
  51.                pixel aspect ratio.
  52.  
  53.           -info
  54.                Dump  the  slide  file  header   on   standard   error,
  55.                displaying  the  original  screen size and aspect ratio
  56.                among other information.
  57.  
  58.           -lib name
  59.                Extracts the slide with the given name from  the  slide
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/1/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      sldtoppm(1)          AMIGA (10 October 1991)          sldtoppm(1)
  71.  
  72.  
  73.  
  74.                library   given   as  input.   The  specified  name  is
  75.                converted to upper case.
  76.  
  77.           -Lib name
  78.                Extracts the slide with the given name from  the  slide
  79.                library  given  as  input.  The name is used exactly as
  80.                specified; it is not converted to upper case.
  81.  
  82.           -scale s
  83.                Scales the image by factor s, which may be any floating
  84.                point  value  greater than zero.  Scaling is done after
  85.                aspect ratio adjustment,  if  any.   Since  scaling  is
  86.                performed  in  the vector domain, before rasterisation,
  87.                the results look much better than running the output of
  88.                sldtoppm through pnmscale.
  89.  
  90.           -verbose
  91.                Dumps the slide file header and lists every vector  and
  92.                polygon in the file on standard error.
  93.  
  94.           -width size
  95.                Scales the image in the vector domain  so  it  is  size
  96.                pixels  wide.   If  no  -height  or  -ysize  option  is
  97.                specified, the height will be adjusted to preserve  the
  98.                pixel aspect ratio.
  99.  
  100.           -xsize size
  101.                Scales the image in the vector domain  so  it  is  size
  102.                pixels  wide.   If  no  -height  or  -ysize  option  is
  103.                specified, the height will be adjusted to preserve  the
  104.                pixel aspect ratio.
  105.  
  106.           -ysize size
  107.                Scales the image in the vector domain  so  it  is  size
  108.                pixels  in  height.   If  no -width or -xsize option is
  109.                specified, the width will be adjusted to  preserve  the
  110.                pixel aspect ratio.
  111.  
  112.           All flags  can  be  abbreviated  to  their  shortest  unique
  113.           prefix.
  114.  
  115.      BUGS
  116.           Only Level 2 slides are converted.  Level 1 format has  been
  117.           obsolete  since the advent of AutoCAD Release 9 in 1987, and
  118.           was not portable across machine architectures.
  119.  
  120.           Slide library items with names containing  8  bit  (such  as
  121.           ISO)  or  16  bit (Kanji, for example) characters may not be
  122.           found when chosen with the -lib option unless  sldtoppm  has
  123.           been   built   with   character   set  conversion  functions
  124.           appropriate to the locale.  You can always  retrieve  slides
  125.           from  libraries regardless of the character set by using the
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/1/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      sldtoppm(1)          AMIGA (10 October 1991)          sldtoppm(1)
  137.  
  138.  
  139.  
  140.           -Lib option and  specifying  the  precise  name  of  library
  141.           member.  Use the -dir option to list the slides in a library
  142.           if you're unsure of the exact name.
  143.  
  144.      SEE ALSO
  145.           AutoCAD Reference Manual:  Slide File  Format,  pnmscale(1),
  146.           ppm(5)
  147.  
  148.      AUTHOR
  149.                John Walker
  150.                Autodesk SA
  151.                Avenue des Champs-Montants 14b
  152.                CH-2074 MARIN
  153.                Suisse/Schweiz/Svizzera/Svizra/Switzerland
  154.                Usenet:  kelvin@Autodesk.com
  155.                Fax:     038/33 88 15
  156.                Voice:   038/33 76 33
  157.  
  158.           Permission  to  use,  copy,  modify,  and  distribute   this
  159.           software  and  its documentation for any purpose and without
  160.           fee  is  hereby   granted,   without   any   conditions   or
  161.           restrictions.   This  software is provided ``as is'' without
  162.           express or implied warranty.
  163.  
  164.           AutoCAD and Autodesk are registered trademarks of  Autodesk,
  165.           Inc.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/1/94)
  196.  
  197.  
  198.  
  199.